@zinn-digital/sdk 0.1.1382 → 0.1.1385

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;
@@ -46057,7 +46057,7 @@ export interface paths {
         };
         /**
          * Read a site's automatic app updates add-on and its window.
-         * @description The paid automatic-updates add-on for the app the site runs (`wordpress_auto_updates`, `woocommerce_auto_updates`, `joomla_auto_updates`, `drupal_auto_updates` or `mediawiki_auto_updates`, USD 29 a year per site; `nextcloud_auto_updates`, USD 50 a year per site; s1014 row 41): whether it is on sale and on, its price in the caller's currency, the renewal, the quiet window and the last run. Each run takes a safety backup first and rolls back to it when the homepage breaks. WordPress: core, plugins and themes (a held plugin version is never applied). Joomla!: the core only, through Joomla's own console; extensions and templates are not updated. Nextcloud: the server through its own updater, then every app with an update. Drupal: the core only (the newest release of the installed major version, then its database updates); contributed modules and themes are not updated. MediaWiki: the newest stable release with its bundled extensions and skins, then its own update script; extensions the customer added are not updated. Buy it through `purchaseExtra` with `site_id`. Requires `sites.view`.
+         * @description The paid automatic-updates add-on for the app the site runs (`wordpress_auto_updates`, `woocommerce_auto_updates`, `joomla_auto_updates`, `drupal_auto_updates`, `mediawiki_auto_updates` or `phpbb_auto_updates`, USD 29 a year per site; `nextcloud_auto_updates`, USD 50 a year per site; s1014 row 41): whether it is on sale and on, its price in the caller's currency, the renewal, the quiet window and the last run. Each run takes a safety backup first and rolls back to it when the homepage breaks. WordPress: core, plugins and themes (a held plugin version is never applied). Joomla!: the core only, through Joomla's own console; extensions and templates are not updated. Nextcloud: the server through its own updater, then every app with an update. Drupal: the core only (the newest release of the installed major version, then its database updates); contributed modules and themes are not updated. MediaWiki: the newest stable release with its bundled extensions and skins, then its own update script; extensions the customer added are not updated. phpBB: the newest release of the installed branch with its bundled style, language and extension, then its own `db:migrate`; styles, language packs and extensions the customer added are not updated. Buy it through `purchaseExtra` with `site_id`. Requires `sites.view`.
          */
         get: operations["getSiteAppAutoUpdate"];
         /**
@@ -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;
@@ -95958,7 +95991,7 @@ export interface components {
             total_ms: number;
             transaction: string;
         };
-        /** @description The paid automatic app updates add-on for one site (s1014 row 41): the code that applies (`wordpress_auto_updates`, `woocommerce_auto_updates`, `joomla_auto_updates`, `nextcloud_auto_updates`, `drupal_auto_updates` or `mediawiki_auto_updates`), the window and the last run's outcome. */
+        /** @description The paid automatic app updates add-on for one site (s1014 row 41): the code that applies (`wordpress_auto_updates`, `woocommerce_auto_updates`, `joomla_auto_updates`, `nextcloud_auto_updates`, `drupal_auto_updates`, `mediawiki_auto_updates` or `phpbb_auto_updates`), the window and the last run's outcome. */
         SiteAppAutoUpdate: {
             /** @description Whether the add-on is on and in good standing now. */
             active: boolean;
@@ -95966,7 +95999,7 @@ export interface components {
              * @description The app the add-on serves on this site, or null when none is sold for it.
              * @enum {string|null}
              */
-            app_key: "wordpress" | "woocommerce" | "joomla" | "nextcloud" | "mediawiki" | "drupal" | null;
+            app_key: "wordpress" | "woocommerce" | "joomla" | "nextcloud" | "phpbb" | "mediawiki" | "drupal" | null;
             can_buy: boolean;
             /** @description The catalogue code to buy (`<app_key>_auto_updates`). */
             code: string | null;
@@ -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.1385",
   "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>",