@zinn-digital/sdk 0.1.1365 → 0.1.1368

package/dist/generated/schema.d.ts

@@ -1767,6 +1767,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/admin/ads/connections/{connection_id}/measurement-health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * Measurement health of any connection, the house included (za-253).
+         * @description Gated on `campaigns.view`. Staff, any connection, the house included: the same payload as `getAdsMeasurementHealth` (docs/1006 §ADSOPT), read from the stored rows — never a network call in the request. Every read is audited: action `ads.measurement_health_viewed` (platform-wide, metadata: the account's `org_id`).
+         */
+        get: operations["getAdminAdsMeasurementHealth"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/admin/ads/kill-switch": {
         parameters: {
             query?: never;
@@ -17977,6 +17999,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/ads/connections/{connection_id}/measurement-health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * Optimisation score, conversion goals, offline uploads and PMax automation (za-253).
+         * @description Gated on `ads.view`. What the daily audit's measurement-health step stored for the caller's own connection (docs/1006 §ADSOPT), never a network call in the request: Google's optimisation score in basis points (`score_bp`, 9307 = 93.07%) with one point per day (`trend`, last 30 days), each enabled campaign's score, the conversion goals that count nothing because their category has no enabled primary action (`goals.missing`: a campaign with nothing left to bid for, a person must choose one; `goals.suggested`: one click to take a goal out of bidding; `goals.switched_off`: done by the autopilot, with Undo on the findings list), the offline-conversion uploads Google reports failing in the last two days (`uploads`, with Google's error code), and each Performance Max campaign's asset-automation switches (`automation`, read only). `checked_at` is null before the first audit.
+         */
+        get: operations["getAdsMeasurementHealth"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/ads/connections/{connection_id}/merchant-feed": {
         parameters: {
             query?: never;
@@ -45873,6 +45917,56 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/sites/{siteId}/app-auto-update": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Site ID (UUIDv7). */
+                siteId: components["parameters"]["SiteId"];
+            };
+            cookie?: never;
+        };
+        /**
+         * 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` or `woocommerce_auto_updates`, USD 29 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 updates WordPress core, plugins and themes in the window, takes a safety backup first and rolls back to it when the homepage breaks. A held plugin version is never applied. Buy it through `purchaseExtra` with `site_id`. Requires `sites.view`.
+         */
+        get: operations["getSiteAppAutoUpdate"];
+        /**
+         * Turn automatic app updates on or off and choose the window.
+         * @description Sets the quiet window (`window_weekday` 0 = Monday to 6 = Sunday, or null for every day; `window_hour` 0-23; an IANA `timezone`). Turning it on needs the add-on on this site (`422 refusal.appAutoUpdate.notOnSite`); a bad hour, weekday or time zone is `422`. Requires `sites.view` and `hosting.applications.manage`.
+         */
+        put: operations["updateSiteAppAutoUpdate"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/sites/{siteId}/app-auto-update/stop": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Site ID (UUIDv7). */
+                siteId: components["parameters"]["SiteId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Stop a site's automatic app updates renewing.
+         * @description Stops the yearly renewal of the site's automatic app updates add-on. Updates keep running until the day before the renewal date and are not refunded. A site without the add-on is `422 refusal.appAutoUpdate.notOnSite`. Requires `sites.view` and `billing.payment.manage`.
+         */
+        post: operations["stopSiteAppAutoUpdate"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/sites/{siteId}/app/previews/{previewId}": {
         parameters: {
             query?: never;
@@ -62862,6 +62956,69 @@ export interface components {
             /** @description Where this market's ads land (its language's page). */
             url: string;
         };
+        /** @description ADSOPT (za-253, docs/1006 §ADSOPT) — what the audit's measurement-health step stored. */
+        AdsMeasurementHealth: {
+            automation: {
+                campaign: string;
+                campaign_id: string;
+                switches: {
+                    [key: string]: boolean;
+                };
+            }[];
+            campaigns: {
+                campaign: string;
+                campaign_id: string;
+                score_bp: number;
+            }[];
+            /** Format: date-time */
+            checked_at: string | null;
+            /** Format: uuid */
+            connection_id: string;
+            goals: {
+                missing: number;
+                open: {
+                    campaign: string;
+                    campaign_id: string;
+                    goal: string;
+                    goals: string[];
+                    /** Format: uuid */
+                    id: string;
+                    /** Format: date-time */
+                    since: string;
+                    /** @enum {string} */
+                    why: "goal_missing" | "suggest_goal_no_primary";
+                }[];
+                suggested: number;
+                switched_off: {
+                    /** Format: date-time */
+                    at: string | null;
+                    campaign: string;
+                    goal: string;
+                    /** Format: uuid */
+                    id: string;
+                }[];
+            };
+            score_bp: number | null;
+            trend: {
+                /** Format: date */
+                day: string;
+                score_bp: number;
+            }[];
+            uploads: {
+                data: {
+                    action: string;
+                    error: string;
+                    failed: number;
+                    /** Format: uuid */
+                    id: string;
+                    last_upload: string;
+                    /** Format: date-time */
+                    since: string;
+                    total: number;
+                }[];
+                failing: number;
+            };
+        };
         /** @description za-188 (docs/1006 §80): a connection's Shopping feed audit. `result` is the last daily audit (empty before the first): `counts` (whole, never capped), `threshold` (`recommended_micros`, `customer_micros`, `used_micros`, `source`), `issues`, `mismatches`, `out_of_stock`, `waste` (each at most 50 rows, most spend first), `stock_pause_link`, `disapprovals_reported` (false on Microsoft — its Content API reports no serving status), `merchant_api` (`off` · `read` · `refused` · `truncated`). Money in micros of the account's currency. */
         AdsMerchantFeed: {
             /** Format: uuid */
@@ -95492,6 +95649,46 @@ 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` or `woocommerce_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;
+            /**
+             * @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" | null;
+            can_buy: boolean;
+            /** @description The catalogue code to buy (`<app_key>_auto_updates`). */
+            code: string | null;
+            enabled: boolean;
+            /** Format: date */
+            ends_on: string | null;
+            /** @description What the last run changed, or why it was rolled back. */
+            last_detail: string | null;
+            /** @enum {string|null} */
+            last_outcome: "updated" | "current" | "rolled_back" | "failed" | null;
+            /** Format: date-time */
+            last_run_at: string | null;
+            /** Format: date-time */
+            next_window_at: string | null;
+            /** @description Whether the add-on is on sale to this organisation. */
+            offered: boolean;
+            /** @description The yearly price in the caller's currency, or null when not on sale. */
+            price: components["schemas"]["MoneyAmount"] | null;
+            /** Format: uuid */
+            purchase_id: string | null;
+            /** @description Why it cannot be bought right now, or null. */
+            refusal: string | null;
+            /** Format: date */
+            renews_on: string | null;
+            /** Format: uuid */
+            site_id: string;
+            timezone: string;
+            window_hour: number;
+            /** @description 0 = Monday to 6 = Sunday; null = every day. */
+            window_weekday: number | null;
+        };
         SiteBackup: {
             /** Format: date-time */
             created_at: string;
@@ -111544,6 +111741,32 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
+    getAdminAdsMeasurementHealth: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The measurement health of this connection. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdsMeasurementHealth"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
     getAdminAdsKillSwitch: {
         parameters: {
             query?: never;
@@ -137591,6 +137814,32 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
+    getAdsMeasurementHealth: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The measurement health of this connection. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdsMeasurementHealth"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
     getAdsMerchantFeed: {
         parameters: {
             query?: never;
@@ -183771,6 +184020,98 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
+    getSiteAppAutoUpdate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Site ID (UUIDv7). */
+                siteId: components["parameters"]["SiteId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The site's automatic app updates state. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SiteAppAutoUpdate"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    updateSiteAppAutoUpdate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Site ID (UUIDv7). */
+                siteId: components["parameters"]["SiteId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    enabled: boolean;
+                    timezone: string;
+                    window_hour: number;
+                    window_weekday?: number | null;
+                };
+            };
+        };
+        responses: {
+            /** @description The site's automatic app updates state after the change. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SiteAppAutoUpdate"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    stopSiteAppAutoUpdate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Site ID (UUIDv7). */
+                siteId: components["parameters"]["SiteId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The renewal is stopped; the state after the change. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SiteAppAutoUpdate"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
     deleteSiteAppPreview: {
         parameters: {
             query?: never;

package/package.json

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