@zinn-digital/sdk 0.1.1407 → 0.1.1410

package/dist/generated/schema.d.ts

@@ -17657,6 +17657,32 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/ads/connections/{connection_id}/copy-winners": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * Copy winners across your own accounts and countries - settings and the last run (za-N5).
+         * @description Gated on `ads.view`. On the caller's own connection. The daily audit (Temporal) finds the responsive search ads that win in a campaign on FIRST-PARTY conversions only (a one-sided two-proportion test against the campaign's other ads at `confidence_pct`, with at least `min_clicks` clicks and `min_conversions` conversions over `lookback_days`) and offers each winner - its ad and keyword set - to the same org's other campaigns, countries and connected accounts on the same website, translated in one batched call where the language differs and checked by the ad-quality gate (docs/1006 §91). Copies are ordinary changes on the TARGET connection (`listAdsChanges`): approve-first in mode `suggest`; approved at once with Undo in mode `auto` when that account's `campaigns` class is Automatic. `pending` counts this account's copies waiting anywhere in the org. Read from stored rows, never a network call in the request.
+         */
+        get: operations["getAdsCopyWinners"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Edit copy winners - switch, mode, thresholds; null puts a threshold back on Recommended (audited).
+         * @description Gated on `ads.manage`. Audit action `ads.copy_winners_update`. `on` is a boolean; `mode` is `suggest` or `auto`; each threshold is a whole number inside its bounds (see `settings.<field>.min/max` in the GET), or `null` for the Recommended value. Any unknown field or invalid value refuses the whole request with `copyWinnersInvalid` (nothing is half-applied).
+         */
+        patch: operations["updateAdsCopyWinners"];
+        trace?: never;
+    };
     "/v1/ads/connections/{connection_id}/crm-sources": {
         parameters: {
             query?: never;
@@ -23049,6 +23075,8 @@ export interface paths {
          *     `state.on_byo` is `true` only when a live customer key exists for **every** provider we route to, so credits genuinely cannot be spent. The banner must stay silent in that case: selling credit to somebody whose every call runs on their own key sells them something that will never be spent. It is **not** "this org has a key" — a customer holding one Anthropic key still pays us for Google, OpenAI and xAI.
          *
          *     Amounts are USD **micros** (1 minor unit = 10,000 micros; 1 USD = 1,000,000), because one model call costs a fraction of a cent and rounding each one up to a penny over-bills by two orders of magnitude. `packs[].price_minor` is ordinary integer minor units, because that is what the customer is charged. Requires `sites.view`.
+         *
+         *     The AI credits an active plan includes (`inference_credits_monthly`, Zinn® AI Hosting) are granted before the balance is read, once per monthly slot of the subscription's period: one credit is 1,000 micros (USD 0.001) of usage at the price charged, so 5,000 credits are USD 5. Only an `active` subscription of an org in good standing earns a grant. The grant appears in `history` as a `grant` row whose `note` is the token `plan_credit:<credits>`, which the dashboard renders as a translated sentence.
          */
         get: operations["getAiCredits"];
         put?: never;
@@ -63144,6 +63172,88 @@ export interface components {
                 uploaded: number;
             };
         };
+        AdsCopyWinner: {
+            ad_group: string;
+            ad_id: string;
+            /** @description The campaign's other ads, pooled. */
+            baseline_rate: number;
+            campaign?: string;
+            campaign_id: string;
+            clicks: number;
+            /** @description First-party conversions only. */
+            conversions: number;
+            /** @description ISO country codes the source campaign targets. */
+            countries: string[];
+            /** @description The source market's language code. */
+            language: string;
+            p_value: number;
+            rate: number;
+        };
+        AdsCopyWinnerCopy: {
+            ad_group: string;
+            campaign?: string;
+            campaign_id: string;
+            /** Format: uuid */
+            change_id?: string;
+            /**
+             * Format: uuid
+             * @description The target connection (same org).
+             */
+            connection_id: string;
+            countries?: string[];
+            descriptions?: string[];
+            detail?: string[];
+            headlines?: string[];
+            keywords?: string[];
+            language: string;
+            /** @description Why it waits - noTranslation, tooLong, gateRefused. */
+            reason?: string;
+            source_ad_id: string;
+            /** @enum {string} */
+            status: "proposed" | "approved" | "waiting";
+        };
+        AdsCopyWinnersEnvelope: {
+            data: {
+                last_run: components["schemas"]["AdsCopyWinnersRun"] | null;
+                /** @enum {string} */
+                mode: "suggest" | "auto";
+                on: boolean;
+                /** @description This account's copies waiting for approval, in any of the org's accounts. */
+                pending: number;
+                settings: {
+                    confidence_pct: components["schemas"]["AdsCompetitorGroupsThreshold"];
+                    lookback_days: components["schemas"]["AdsCompetitorGroupsThreshold"];
+                    min_clicks: components["schemas"]["AdsCompetitorGroupsThreshold"];
+                    min_conversions: components["schemas"]["AdsCompetitorGroupsThreshold"];
+                };
+            };
+        };
+        AdsCopyWinnersPatch: {
+            confidence_pct?: number | null;
+            lookback_days?: number | null;
+            min_clicks?: number | null;
+            min_conversions?: number | null;
+            /** @enum {string} */
+            mode?: "suggest" | "auto";
+            on?: boolean;
+        };
+        AdsCopyWinnersRun: {
+            /** @description Copies approved at once (mode auto). */
+            applied: number;
+            /** Format: date-time */
+            at: string;
+            copy_list: components["schemas"]["AdsCopyWinnerCopy"][];
+            /** @description Targets that already have the group or a decided copy. */
+            covered: number;
+            /** @description Campaigns skipped because they advertise another website. */
+            other_site: number;
+            proposed: number;
+            /** @description Empty when it ran; else why not (switchedOff, noFirstPartyProof, notInGoodStanding, ...). */
+            skipped: string;
+            waiting: number;
+            winner_list: components["schemas"]["AdsCopyWinner"][];
+            winners: number;
+        };
         /** @description COUNTRYCUT — our recommended values, in the connection's currency. */
         AdsCountryCutRecommended: {
             currency: string;
@@ -138496,6 +138606,63 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
+    getAdsCopyWinners: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The switch, mode, thresholds (each with its Recommended value) and the last run. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdsCopyWinnersEnvelope"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    updateAdsCopyWinners: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AdsCopyWinnersPatch"];
+            };
+        };
+        responses: {
+            /** @description The settings after the change. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdsCopyWinnersEnvelope"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
     listAdsCrmSources: {
         parameters: {
             query?: never;

package/package.json

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