@zinn-digital/sdk 0.1.1366 → 0.1.1369

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;
@@ -62912,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 */
@@ -69699,10 +69806,16 @@ export interface components {
             note?: string;
         };
         BulkJobDetail: components["schemas"]["BulkJob"] & {
+            /** @description For a `find_file` job: the refusal key (e.g. `refusal.bulk.fileProtected`) a `delete_file` of the same path would get, so a report never offers a delete the engine will refuse. `null` when the delete is allowed, and for every other operation. */
+            delete_refusal: string | null;
             items: components["schemas"]["BulkJobItem"][];
         };
         BulkJobItem: {
             error_code: components["schemas"]["BulkErrorCode"] | null;
+            /** @description For a `find_file` or `delete_file` item that succeeded: the file's size and last modified time. `null` for every other item, and for a file item written before these facts were recorded. */
+            file: components["schemas"]["BulkJobItemFile"] | null;
+            /** @description Whether `retry-failed` would reopen this item: every `failed` item, and every `skipped` item whose code is not a final answer. A search that found no such file (`file_missing`, `file_not_regular`) has answered and is not retried. Count these to label a retry control; do not re-derive the rule from `status`. */
+            retryable: boolean;
             /** Format: date-time */
             settled_at: string | null;
             /** @description Carried on the row rather than joined, so the report survives the site being deleted mid-job — which, on a long run, is not hypothetical. */
@@ -69710,6 +69823,18 @@ export interface components {
             site_id: components["schemas"]["Uuid"];
             status: components["schemas"]["BulkItemStatus"];
         };
+        BulkJobItemFile: {
+            /**
+             * Format: date-time
+             * @description When the file was last modified, as the site's filesystem reports it.
+             */
+            modified_at: string;
+            /**
+             * Format: int64
+             * @description Size in bytes. Format it for the reader's locale.
+             */
+            size_bytes: number;
+        };
         /** @description The operation's arguments. Which keys are read depends on `operation`: `plugin_install` takes `slugs` + `activate`; `plugin_activate`, `plugin_deactivate` and `plugin_remove` take a single `slug`; `plugin_update` takes `slugs` and treats an empty list as *"everything with an update waiting"*, which is what a bulk update means in practice; `theme_install` takes `slug` + `activate`; `blueprint_apply` takes `blueprint_id`; `wp_search_replace` takes `search` + `replace`; `stack_apply`, `core_update` and `application_install` take nothing. ⛔ `application_install` deliberately accepts no `admin_email` or title: they come from the site's own blueprint and plan, exactly as they do for a single-site provision, because a bulk field for them is an account-takeover primitive with a form in front of it. */
         BulkJobParams: {
             /**
@@ -111634,6 +111759,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;
@@ -137681,6 +137832,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;

package/package.json

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